home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu295.dms / pu295.adf / Logging / CQWWLog / CQWWLOG.DOC < prev    next >
Text File  |  1988-12-18  |  6KB  |  129 lines
  1. CQWWLOG.BAS
  2. Original program by Clarke Greene K1JX
  3. Amiga version by John Gager K7KB
  4.  
  5. [See bug report at end of this file.]
  6.  
  7. This ARC contains the Microsoft BASIC (tm) source code for the CQ World Wide
  8. DX Contest log editing program listed in the "Contests" chapter of The ARRL
  9. Operating Manual, Third Edition. The program takes an ASCII log listing (as
  10. created by you with your favorite word processor), and produces a log package 
  11. suitable for submission to the contest sponsor. Three separate files are
  12. produced:
  13.  
  14.     1. A LOG file - (identified by the filename extension ".LOG"). This file
  15.        holds the actual log.  New multipliers are identified and counted, QSO
  16.        point value noted, and duplicate contacts identified.
  17.  
  18.     2. A DUPE SHEET file - (identified by the filename extension ".DUP"). This
  19.        file holds a dupe sheet as required by the contest sponsors. This is a
  20.        complete listing of all the contacts made on a particular band, in
  21.        alphabetical order.
  22.  
  23.     3. A SUMMARY file - (identified by the filename extension ".SUM"). This
  24.        file holds a summary sheet for the band edited. Total valid QSOs,
  25.        duplicate QSOs, total QSO points, Countries worked, and Zones worked
  26.        are listed as well as a complete breakdown of QSOs per country and QSOs 
  27.        per zone.
  28.        
  29. The file containing the log entries must be an ASCII file in the 
  30. following format:
  31.  
  32.     TIME      CALLSIGN      RCV'D REPORT
  33.  
  34. At least one space must be between each field of each log entry, and each line
  35. must be terminated by a carriage return. Only a changed digit in the time
  36. field must be present; for example, if the contest begins at 1800Z and the
  37. first contact is made at 1802Z and the second contact is made at 1805Z, then
  38. only 5 need be entered in the time field. If the third contact is made at 
  39. 1812Z, then 12 should be entered in the time field. If the next contact is
  40. made at 1812Z, then no number need be entered in the time field (however, be
  41. sure to enter a space to indicate separation between fields). If no signal
  42. report is entered as part of the received report, 59(9) (depending on the
  43. mode) is assumed.
  44.  
  45. The three output files (.LOG, .DUP, and .SUM files) can be 
  46. printed by using the Amiga TYPE command.
  47.  
  48. Some reminders:
  49.  
  50. 1. Be sure your log is in an ASCII format. Just about every word processor
  51.    can operate in an ASCII or Non-Document mode - that should work fine. As
  52.    an alternative, you can use one of the many utilities available in the
  53.    marketplace and in the public domain to convert your word processor output
  54.    into an ASCII format.
  55.  
  56. 2. If you enter the callsigns in your log in lowercase, they are automatically
  57.    converted to uppercase for the final .LOG file.
  58.  
  59. 3. Since you probably will copy this program onto a working disc (rather than
  60.    suffer the usual consequences of Mr. Murphy), remember that CQWWLOG needs
  61.    access to DXPREFIX.LIB. DXPREFIX.LIB must be on the same disc as this
  62.    program, and in the root or main directory of your disk.
  63.  
  64. 4. Each band requires a separate entry file. The output files will be named
  65.    as the original filname plus the appropriate extension (for example
  66.    CQCW15.LOG, CQCW15.DUP, and CQCW15.SUM would be produced from the log entry
  67.    file CQCW15.) As a consequence of this, any file with the same name will be
  68.    overwritten when CQWWLOG is run. To avoid any deletion of valid files, use
  69.    unique names for the files used on each band, and don't use the extensions
  70.    .LOG, .DUP, or .SUM.
  71.  
  72. Special notes for Amiga Version
  73. -------------------------------
  74.  
  75. This ARC contains 4 files:
  76.  
  77. CQWWLOG.BAS  -  AmigaBasic program
  78.  
  79. CQWWLOG.DOC  -  This documentation file
  80.  
  81. CQWWLOG.DAT  -  A small log file used to show example log entrys and to test
  82.                 the CQWWLOG.BAS program.
  83.  
  84. DXPREFIX.LIB -  A file of DX prefixes and countries used by this program.
  85.  
  86.   To give credit where credit is due, this program is by Clarke Greene K1JX.
  87. The only thing I've done is go through his program and make it more agreeable
  88. with AmigaBasic, and add a few minor features along the way. I really haven't
  89. had a chance to test this program throughly since I don't get into contesting
  90. very much, but I believe it is free of any major bugs. If you find any bugs
  91. that I have missed, or have suggestions and comments about these programs,
  92. please let me know.
  93.  
  94.   One thing you will notice about these programs is that they are SLOW!! For
  95. example, I wrote a program that created a log using random prefixes from the
  96. DXPREFIX.LIB file. It created a log of 1439 entries, and the IARULOG.BAS
  97. program took about 1 1/2 hours to process the log! So patience is certainly a
  98. virtue when processing a large log. Although it would have been nice to
  99. compile these programs since I have the Absoft basic compiler, after I ran
  100. the compiled version of IARULOG on the same fake log, it took over 3 hours to
  101. process it! In some defense of Absoft, the MiniMuf program I wrote runs
  102. considerably faster compiled.
  103.  
  104. 73,
  105.  
  106. John Gager K7KB
  107. CompuServe ID 71336,624
  108.  
  109. Bug Report:
  110.  
  111. 1. An error in the source listing as printed in the Operating 
  112.    Manual caused a error message to appear when running CQWWLOG
  113.    "ILLEGAL FUNCTION 1530".  This has been fixed in both the
  114.    source listing and the executable file.  (Tnx WA2WIP)
  115.  
  116. 2. Expanded DXPREFIX.LIB memory allocation for bigger library.
  117.  
  118. 3. Added ability for program to distinguish between between USA
  119.    prefix ambiguities (i.e. KG6= Guam vs. KG6= Calif.).  (Tnx WD5K)  
  120.  
  121. Amiga features include:
  122.  
  123.  * Automatic capitalizing of entries read from log source file.
  124.  
  125.  * Automatic capitalizing of keyboard entries from program prompts.
  126.  
  127.  * Expanded error checking for improper data read both from the log
  128.    source file and the keyboard.
  129.